home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 016a / get25.zip / GET-READ.ME next >
Text File  |  1991-11-30  |  9KB  |  153 lines
  1.   GET-READ.ME            GET Version 2.5          Copyright 1991 Bob Stephan
  2.  
  3.   READ.ME
  4.  
  5.     GET.EXE is a general purpose DOS BATch file enhancer.  It makes informa- 
  6.       tion available to BATch files through the BATch IF subcommand.  The 
  7.       information can come from user input or from the operating system, and 
  8.       it is made available to the BATch file through the DOS ErrorLevel (Exit 
  9.       Code) and variables in the DOS master Environment. GET also has capabil- 
  10.       ities to set some system parameters and perform a few other specific ac- 
  11.       tions, over 30 functions in all.  Not only is GET wonderful for automat- 
  12.       ing your personal system, it is excellent for client support and soft- 
  13.       ware installation programs.  If these terms are not familiar to you,
  14.       you will find them fully described and explained in the 60 page manual
  15.       in the file GET.DOC. If you have been using an older version of GET, 
  16.       you will also be interested in the information in GET25NEW.DOC to help
  17.       focus on the new and improved features.
  18.  
  19.     One BATch file that just about every PC user has some familiarity with
  20.       is AUTOEXEC.BAT.  Have you ever felt the need to be more creative
  21.       in what your AUTOEXEC.BAT or other BATch files can be made to do?
  22.       That is the purpose of BATch enhancers, such as GET.EXE.
  23.  
  24.     The BATch programming language is a simple language.  The DOS manual
  25.       describes only 8 subcommands specific to BATch files.  This makes it
  26.       very easy to program simple BATch files - much easier than, say,
  27.       spreadsheet macros or database programs.  At the same time BATch does
  28.       not support many of the more interesting things we would like to be
  29.       able to do in BATch files.  That is where GET comes in.
  30.  
  31.     GET makes it possible to do many more interesting things in your BATch
  32.       files than is possible with plain DOS.  GET has over 30 functions that
  33.       are useful in BATch files, so it can replace a multitude of small BATch
  34.       file utilities, thus saving disk space.  Each BATch file will probably
  35.       use only a few features, but as you become familiar with the power of
  36.       GET you will find more and more uses for all the features.
  37.  
  38.     The functions available in GET.EXE fall into three general categories:
  39.  
  40.       1. Keyboard and Screen Input and Output
  41.       2. Disk and File Information
  42.       3. Memory and System Information
  43.  
  44.     Some of the many things you can do with the Keyboard and Screen I/O are:
  45.  
  46.       Echo text to the screen in color or reverse video.
  47.       Display a custom prompt, optionally in color or reverse video, and get
  48.          keyboard input.  The prompt can even be displayed as a line of text
  49.          moving across the bottom line of the screen to attract attention.
  50.       Obtain keyboard input for menu selection, yes/no answers, USER IDs and
  51.          passwords, just to mention a few, then take appropriate action
  52.          depending on what was entered.  You can control the length, valid
  53.          characters, case, length of time to wait for input, and other 
  54.          characteristics of what is to be entered.
  55.       Manipulate character (string) information to extract substrings, 
  56.          control the case, measure the length, provide input to other 
  57.          programs, trim leading and/or trailing blanks, and/or write 
  58.          the information to files.
  59.       Clear the screen with full control of background and foreground color,
  60.          automatically adjusting for the number of lines of text on the
  61.          screen such as 43 for VGA or 50 for EGA.
  62.       Arithmetic - add or subtract two numbers to make a loop counter,
  63.          create sequential file names, or simply convert a numerical
  64.          Environment variable into an ErrorLevel.
  65.  
  66.     Some of the many things you can do with the Disk and File functions are:
  67.  
  68.       Your BATch file can find out how large a file is, or how much space
  69.          is available on a disk.  Decisions can be programmed based on this
  70.          information, for example, to do a COPY only if enough free space
  71.          is available.
  72.       You can determine whether a formatted disk is available in a floppy 
  73.          drive, and determine its size without getting the dreaded "Abort,
  74.          Retry, Ignore" critical error message.
  75.       Your BATch file can check the volume label of a disk and take 
  76.          appropriate action based on which disk has been inserted in the
  77.          drive.  You can check that the correct backup, installation, data,
  78.          or program disk has been inserted, for example.
  79.       You can determine which device drivers were loaded in a CONFIG.SYS file
  80.          and have your AUTOEXEC.BAT automatically make decisions about which
  81.          programs to run depending on the system configuration. 
  82.       Your BATch file can obtain and store the current drive and directory
  83.          so it can return there after performing an action or running a
  84.          program in a different drive or directory.
  85.  
  86.     A few of the many things you can to with the Memory and System 
  87.          functions are:
  88.  
  89.       Get date and time information to use to control when to run other
  90.          programs, to time stamp information in files, to display on the
  91.          screen or for many other purposes.
  92.       BATch files can find out how much memory is available, how much
  93.          Environment space is left, what video attributes and modes are in
  94.          use, whether a math coprocessor is available, and whether the CPU
  95.          is an 8086, 80286, or 80386 (among other things).  Many BATch 
  96.          programming decisions can be based on such information.  Additional,
  97.          checks are whether ANSI.SYS has been loaded, or whether Microsoft
  98.          Windows is running.
  99.       Your BATch file can check to see if a printer is available and ready
  100.          and determine whether to print or not automatically.  It can even
  101.          turn off Print Screen to avoid accidental hang-ups if no printer
  102.          is currently on-line.
  103.       You can even have your BATch file reboot your computer with either a
  104.          warm or cold boot, for example to change the configuration.
  105.          
  106.     The 60 page manual not only describes these and other features in full
  107.        detail, it also gives many examples and BATch programming hints.
  108.  
  109.     LICENSING SUMMARY
  110.  
  111.     GET is copyrighted software and is not in the public domain!  GET is not 
  112.       totally free for all users, and there are conditions imposed on its dis- 
  113.       tribution.  Please read this information and the section on Licensing 
  114.       and Distribution to be sure you are not using GET illegally.  The only 
  115.       version of GET that is free is the one that displays the help screen 
  116.       when the name GET is entered at the DOS prompt by itself.  If you have 
  117.       one that says it is licensed and you have not registered, you have a 
  118.       pirated copy that is protected by law.
  119.  
  120.     VENDORS, CORPORATE, and COMMERCIAL users see licensing terms under Licens- 
  121.       ing and Distribution in GET.DOC.
  122.  
  123.     INDIVIDUALS, SHAREWARE AUTHORS, and SYSOPS.  For individuals this version 
  124.       of GET is free for personal use, and for the use of shareware authors in 
  125.       distributing their products subject to the conditions specified in the 
  126.       Licensing and Distribution terms in GET.DOC. GET.EXE may be freely copied 
  127.       and distributed provided that all files in the GET25.ZIP package, including 
  128.       but not limited to GET.DOC and GET25NEW.DOC, are included on the disk or 
  129.       in the compressed file with GET.EXE.  Contributions to support this de- 
  130.       velopment project will be gratefully accepted.  If you use GET and can't 
  131.       send money, at least send thanks.  Programmers do not live by bread 
  132.       alone.  Besides, I'll put you on the list to receive new releases as 
  133.       they become available.
  134.  
  135.     If you send $15 or more (overseas $20 U.S. funds) you will receive the 
  136.       following benefits: (California residents please add 7.75% sales tax).
  137.  
  138.       The latest version of GET with any new features plus one free upgrade.
  139.       A smaller runtime version to distribute with your BATch files.
  140.       A single user license with no royalties for use of the runtime version.
  141.       A >60 page user manual giving examples and detailed explanations.
  142.       Free support by BBS, mail, phone, CompuServe, or Genie (see below).
  143.       Notification of new releases and upgrades after the first one.
  144.  
  145.    If you have a modem, VISA and MASTERCARD registrations can be entered via 
  146.       NITELOG BBS, 408-655-1096.  After completing the brief sign-on registra- 
  147.       tion, enter S for Script, then 3 for Script 3.
  148.  
  149.     If you have any questions, comments, or suggestions please contact me at:
  150.           MOBY DISK: 1021 San Carlos Road, Pebble Beach, CA 93953
  151.       Phone: (408) 646-1899/1373.    GENIE:MOBYDISK.    COMPUSERVE:72357,2276
  152.       BBS: The Cricket 408-373-3773        /s/ Bob Stephan  November 27, 1991
  153.